home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / text / prism_1.5 / prism.doc < prev    next >
Text File  |  1994-11-17  |  14KB  |  310 lines
  1.                      _____  _____  ___  _____  __   __
  2.                     /    / /    / /  / / ___/ / /  / /
  3.                    / ___/ / ___/  //  / /__  /  \_/ /
  4.                   / /    /  \    //  _\__ / / /\_  /
  5.                  /_/    /_/\_\ /__/ /____/ /_/  /_/
  6.  
  7.                                 Version 1.5
  8.            Copyright (c)1992 Legendary Design Technologies Inc.
  9.  
  10.                 Program and Documentation by Syd L. Bolton
  11.          Earlier Versions: Colin Vernon (orig.) & Chris Timmerberg
  12.  
  13. NOTE: Please read the file "READ.ME" included with this distribution
  14. archive.  It contains the latest release notes, as well as information
  15. regarding the various changes PRISM has gone through.
  16.  
  17. WHAT IS PRISM?
  18. ==============
  19.  
  20.     Prism is an ANSI ANIMATOR.  It is a drawing program, but it will
  21. not create hi-resolution pictures like DPaint (tm Electronic Arts) or other
  22. paint programs.  Instead, it is used to generate color screens that are used
  23. on BBS's (Bulletin Board Systems) or it can also be used for title screens
  24. for anything you do in the CLI or for the console.device.
  25.     Prism differs from many other ANSI programs in that it will remember
  26. the SEQUENCE in which you draw characters, and will play them back in that
  27. order to simulate animation.  It also contains features not found in any
  28. other package.
  29.  
  30. RUNNING PRISM
  31. =============
  32.  
  33.     Prism requires only the executable file (called "PRISM") to run.
  34. If you are running from Workbench, of course, the icon file (PRISM.INFO) will
  35. be needed (and it is included).  There is a file called "PRISM.CFG" which
  36. contains the configuration information.  IT IS NOT INCLUDED with this
  37. archive, but it is NOT NECESSARY to run the program.  The program itself
  38. will generate this file when you SAVE any configurations.
  39.     PRISM 1.4 OWNERS: If you already have a configuration file from
  40. PRISM 1.4, keep it with the new version of the program.  PRISM 1.5 WILL
  41. load the old configuration file, and then you can SAVE a new one as soon
  42. as you wish.
  43.  
  44.     There are no command line options, or Workbench TOOL TYPES.  All
  45. settings are done through three (3) configuration editors, and the config
  46. file (if found) is loaded at startup.
  47.  
  48. A QUICK TOUR OF THE MAIN SCREEN
  49. ===============================
  50.  
  51.     When PRISM opens, you will notice a toolbox appear at the bottom
  52. of the screen.  This, in conjunction with the menus, is how you access
  53. all of PRISM's features.  Since this is primarily a text-based system,
  54. the keyboard is where you will spend most of your time.
  55.     The color gadgets (which are labeled 0-15) are used to change
  56. colors.  In the title bar of the toolbox you will see the current color
  57. settings.  You can change both the foreground (front) and background (back)
  58. colors.  PLEASE NOTE, that in accordance with ANSI standards that the
  59. foreground colors can be from 0-15, but the background colors can ONLY be
  60. 0-7.
  61.     Normally, clicking on a color gadget will change the color of the
  62. foreground, IF you are in foreground mode (the default).  If you want to
  63. change the background color (just once) then click on the BACK COL gadget.
  64. The next color you select will become the background color.  If you are
  65. doing a lot of background color changes, you might want to change into
  66. background mode (in other words, the color clicks normally change the
  67. background color instead of the foreground).  If you click on the "FORE"
  68. gadget, you will notice the gadgets change from:
  69.  
  70.     BACK    FORE            You are in FOREground mode. Normal
  71.     COL                clicks change the foreground color.
  72.  
  73. to:
  74.  
  75.     FORE    BACK            You are in BACKground mode. Normal
  76.     COL                clicks change the background color.
  77.  
  78.     Now many also be a good time to look at the title bar in more
  79. detail.  You can find a lot of vital statistics here.
  80.  
  81.  _Position in the file
  82. |     _Length of the file             Cursor X&Y     Pointer X&Y
  83. |    |      _Foreground color             _|__        __|__
  84. |    |     |          |Background color  |    |      |     |
  85. Pos:   Len:   ForeC:    BackC:             CX:   Y:    PX:    Y:
  86.  
  87. POS: Position in the file.  This will give you some idea of where you are.
  88. Remember, PRISM remembers the order of the keystrokes.
  89.  
  90. LEN: This is the total number of characters.  Remember, this is NOT the
  91. length of the file that will get written out (it will usually be quite a
  92. bit bigger, depending upon the ANSI sequences needed).
  93.  
  94. FOREC: The current foreground color, displayed so that you be sure you are
  95. on the correct color.
  96.  
  97. BACKC: The current background color.
  98.  
  99. CX&Y: This is where the cursor currently is, in terms of a CHARACTER MATRIX
  100. (ie: The screen resolution for pixels is 640x200, but for characters it is
  101. 80x25).
  102.  
  103. PX&Y: This is where the POINTER currently is, in CHARACTER MATRIX co-
  104. ordinates.  This is handy if you are trying to determine which position
  105. something should go in without actually moving the CURSOR (just the
  106. pointer).
  107.  
  108.     You will also notice a gadget labelled "QUICK PICK".  When clicked,
  109. this will bring up the QUICK PICK requester.  This requester contains all
  110. of the valid characters you can type, including some that are hard to
  111. duplicate with the keyboard.  Simply click on the character you wish to
  112. insert, and it will appear.  If you wish to abort this function, click on
  113. the close gadget.  QUICK PICK is also used in other parts of the program.
  114.  
  115.     There are three gadgets that do something very special.  The first
  116. one looks like a box.  The second is a horizontal line, and the third is
  117. a vertical line.  They do exactly what they seem to be, ie: the box gadget
  118. lets you draw a box with the mouse, and so on.  Let's look at these in
  119. more detail:
  120.  
  121. DRAWING BOXES
  122. =============
  123.  
  124.     When you click on the DRAW BOX gadget, you will notice the main
  125. title bar change the indicate you are in BOX mode.  If you click on a
  126. gadget (say to change the color) AFTER you are in box mode, it will CANCEL
  127. BOX MODE and you will have to reselect it.  This allows you to cancel the
  128. procedure if you don't wish to use it.  This mode, as well as the others,
  129. will draw a box in the current fore & background colors.  Obviously, it is
  130. wise to choose your colors first, and then choose box.  To draw a box,
  131. simply move the cursor to where you want the box to begin, and holding the
  132. left button down drag out a box as big as you need it.  NOTE: If you
  133. decide to cancel after you have started drawing, PRESS THE SPACE BAR!  This
  134. will cancel the box.
  135.     Otherwise, when you release the button, a box will be drawn USING
  136. ASCII characters.  Because PRISM is an ANIMATION program, the box is drawn
  137. in a certain direction.  YOU determine the direction by where you start the
  138. box.  In other words, if you start in the upper left corner, the order will
  139. go a certain way.  If you start in the bottom right, the order will be
  140. different.  The following diagarams should help you visualize this.  The
  141. "*" indicates where the box was started from:
  142.  
  143.       *  -->               <--   *
  144.        --------          --------          --------          --------
  145.        |      | |      | |      |          |      | ^      ^ |      |
  146.        |      | |      | |      |          |      | |      | |      |
  147.        |      | \/    \/ |      |          |      | |      | |      |
  148.        --------          --------        * --------          --------  *
  149.                                              -->               <--
  150.  
  151.     As you can see, from wherever you start the box, the drawing will
  152. travel along the horizontal axis (either right or left) and then go
  153. vertically.
  154.     ANOTHER IMPORTANT POINT: After you start drawing a box (or a line)
  155. you may wish to get rid of the toolbox so you can better see what you are
  156. doing.  You can do this WHILE YOU ARE DRAWING (or at any other time) by
  157. pressing the HELP KEY.  The toolbox will disappear.  Press HELP to bring it
  158. back again.
  159.     See the section on "CONFIGURING BOXES" for more details about
  160. boxes.
  161.  
  162. DRAWING LINES
  163. =============
  164.  
  165.     PRISM also allows you to easily draw lines.  This way, you can
  166. create menus and displays using columns very easily.  Click on either the
  167. horizontal (left and right) or vertical (up and down) line gadgets, and the
  168. main title bar will change to indicate which type of line you are drawing.
  169.     Like the box mode, simply move the cursor to the start of the line,
  170. ho